Mestrado e Doutorado
Jurimetria e visualização
de dados jurídicos
Um número só serve como evidência quando vem com a origem, o recorte e o denominador.
Mestrado e Doutorado
Duas bases prontas, uma pergunta de pesquisa
| Base | Aula | Cada linha é |
|---|---|---|
| corpus.csv | 1 | um documento coletado |
| corpus_extraido.csv | 2 | o documento, com as variáveis extraídas |
As bases internas do playground (o corpus e o extraído de cada aluno) entram direto no Painel. Hoje o painel é dos documentos.
O incidente de desconsideração funciona?
Quem não tiver corpus próprio usa as bases de exemplo do playground (dados fictícios, 2.000 linhas cada):
Mestrado e Doutorado
Da delimitação do escopo à publicação dos resultados
| Passo | O que é |
|---|---|
| 1 · Definição do problema | objetivos, perguntas, métricas de sucesso |
| 2 · Coleta e aquisição | fontes, APIs, integração |
| 3 · Limpeza e tratamento | qualidade, ausentes, duplicatas, extração |
| 4 · Análise exploratória | estatística descritiva, padrões |
| 5 · Modelagem e treinamento | algoritmos que preveem |
| 6 · Implantação e monitoramento | painéis ou automação |
| 7 · Publicação e comunicação | relatórios, visualizações |
Mestrado e Doutorado
A pergunta mais importante: o que é uma linha da tabela?
Unidade de análise
processo, decisão, parte ou respondente? Um processo com três decisões conta como um ou três?
Dados ausentes
vazio não é zero; "não identificado" é informação: contar como "não" distorce a taxa
Inconsistências
caso real do DataJud: assunto de código 99999999, sem nome. Datas impossíveis, duplicatas
Mestrado e Doutorado
Os 4 critérios de uma boa visualização
Clareza
fácil de entender, direta
Precisão
sem distorcer nem exagerar
Coerência
estilo, cores e tipografia consistentes
Eficiência
o mínimo de elementos
O Painel do playground aplica um quinto: coesão. Cada seção responde a uma pergunta que decorre da anterior.
Mestrado e Doutorado
Cada propósito pede uma família de gráfico
| Família | Para quê | Exemplos |
|---|---|---|
| Informação | trazer um conteúdo direto | número em destaque, pictograma |
| Comparação | confrontar valores | colunas, barras, butterfly |
| Distribuição | como os valores se espalham | histograma, boxplot |
| Organização | relacionar de forma estruturada | calendário de calor, cordas |
| Correlação | comparar pares de variáveis | dispersão, mapa de calor, Sankey |
| Proporção | partes de um todo | pizza, treemap |
| Localização | situar no mapa | coroplético, isolinhas |
Mestrado e Doutorado
A pergunta que escolhe o gráfico: o que eu quero mostrar?
O mapa parte de uma pergunta no centro e abre em sete ramos: comparação, distribuição, correlação, proporção, informação, localização e organização. Cada ramo termina em dois ou três gráficos. Nos próximos slides, um ramo por vez.
Baixar o cheat sheet (PDF)Mestrado e Doutorado
Comparar com outros ou consigo mesmo; ao longo do tempo ou num instante
| Comparo… | …ao longo do tempo (longitudinal) | …num só instante (transversal) |
|---|---|---|
| com outros (tribunais, classes, varas) | áreas empilhadas · linhas empilhadas | barras ou colunas · barras agrupadas · barras empilhadas · radar · butterfly |
| comigo mesmo (uma série, antes × depois) | waterfall · barras agrupadas · linha | pizza diferencial · barras diferenciais · scatter diferencial |
Longitudinal: as mesmas unidades acompanhadas no tempo. Transversal: um recorte só, várias unidades ao mesmo tempo. E comparação entre grupos só vale com denominador: taxa, não contagem.
Mestrado e Doutorado
Como os valores de uma variável se espalham
Histograma
a forma da distribuição: onde a maioria está, se há cauda longa
Error bar
a média com a sua margem de variação
Boxplot
mediana, quartis e os casos extremos, de uma vez
Tempo de tramitação é o caso típico: poucos processos que duram anos puxam a média; o boxplot mostra isso, a média esconde.
Mestrado e Doutorado
Duas variáveis andam juntas?
Scatter plot
um ponto por caso: valor da causa × tempo
Bubble plot
scatter com uma terceira variável no tamanho
Sankey
de onde vem e para onde vai: classe → resultado
Heatmap
duas categorias e uma intensidade: UF × problema
Matriz de correlação
todas as variáveis numéricas, duas a duas
Correlação no gráfico não é causa. Quase sempre existe uma terceira variável explicando as duas.
Mestrado e Doutorado
Partes de um todo
Pizza
poucas partes, uma dominante; mais de cinco fatias, não
Rosca
a pizza com o total no meio
Treemap
muitas partes, hierarquia: tribunal → vara → classe
Proporção exige o total ao lado. Sem o N, a fatia de 61% pode ser 11 casos.
Mestrado e Doutorado
Um dado em destaque, ou o resumo de um texto
Destaque
- Grande número: o N, a taxa, o tempo mediano
- Pictograma: a proporção em bonequinhos
- Acelerador / gauge: um valor contra uma meta
Resumo
- Wordcloud: as palavras mais frequentes de um corpus
- Wordtree: como uma palavra é usada nas frases
O grande número é o gráfico mais usado em painel jurídico: um N, uma taxa. Serve se vier com origem e recorte.
Mestrado e Doutorado
Onde: situar os dados no mapa
Mapa de pontos
um ponto por ocorrência: comarcas, fóruns
Mapa coroplético
regiões pintadas por valor: taxa por UF
Mapa de isolinhas
superfícies contínuas: densidade
Coroplético de contagem pinta o tamanho da população, não o fenômeno. Pintar taxa, não total.
Mestrado e Doutorado
Relacionar informações de forma estruturada: no tempo, em hierarquia ou em rede
| Organização… | Gráficos | Exemplo jurídico |
|---|---|---|
| temporal | Gantt · timeline · calendar heatmap | as fases de um processo; decisões por dia no calendário |
| hierárquica | treemap · organograma · dendrograma · sunburst | tribunal → câmara → relator |
| relacional | cordas · Sankey · rede de grafos | quem litiga contra quem; partes e advogados em comum |
A rede de grafos volta na Aula 6: é o cruzamento de partes e advogados entre decisões.
Mestrado e Doutorado
Jogo dos 7 erros
Sete gráficos com a família errada. Para cada um: qual critério foi violado e qual família resolveria?
Mestrado e Doutorado
Processos contra companhias aéreas: seis variáveis, sete gráficos
Mapeamento do mau atendimento das companhias aéreas no território nacional. Cada processo traz: UF, tipo de tribunal (Justiça comum ou Juizado especial), data de protocolação, data da sentença, valor da causa e decisão judicial (procedente, improcedente, parcialmente procedente).
- Clarezaentende-se em segundos, sem legenda decifrada.
- Precisãoo olho lê o valor certo; nada distorce.
- Coerênciaa família combina com a pergunta e com o tipo de dado.
- Eficiêncianenhuma tinta sem informação.
Sete gráficos a seguir usam a família errada. Para cada um: qual critério foi violado e qual família resolveria? Use o cheat sheet. Dados ilustrativos.
Mestrado e Doutorado
Para cada gráfico: critério violado e família certa
| # | O gráfico quer mostrar | Critério violado? | Família certa? |
|---|---|---|---|
| 1 | proporção de processos por tipo de justiça (2022) | ||
| 2 | casos por dia da semana ao longo de jan/2023 | ||
| 3 | ocorrências por tipo de problema (2023) | ||
| 4 | valor médio da causa por mês, 2º semestre de 2022 | ||
| 5 | associação entre UFs e tipos de problema (2022) | ||
| 6 | distribuição por problema dentro de cada UF | ||
| 7 | distribuição por UF dentro de cada problema |
Mestrado e Doutorado
Proporção de processos distribuídos por tipo de tribunal em 2022
Mestrado e Doutorado
Ocorrência de casos distribuídos por dia da semana ao longo de jan/2023
Mestrado e Doutorado
Comparação de ocorrência de casos por tipo de problema em 2023
Mestrado e Doutorado
Comparação de valores médios de causa no último semestre de 2022 por cancelamento de voo
Mestrado e Doutorado
Associações entre UFs e tipos de problema levantados em 2022
Mestrado e Doutorado
Distribuição de processos levantados em 2022 para cada problema avaliado em cada UF
Mestrado e Doutorado
Distribuição de processos levantados em 2022 para cada problema avaliado em cada UF
Mestrado e Doutorado
Processos distribuídos em 2022: 81,5% na Justiça Especial
Violou: Coerência: a linha liga duas categorias como se houvesse um caminho entre elas. Precisão: o título promete proporção e o eixo mostra contagem. Família certa: Proporção → pizza de duas fatias (ou barra 100%), com o percentual escrito.
Mestrado e Doutorado
Casos distribuídos por dia útil, jan/2023: segunda concentra, quinta esvazia
Violou: Precisão: empilhar soma semanas que não se somam; a área entre dias inventa continuidade. Clareza: 20 números espremidos. Família certa: Organização → calendário de calor (semana × dia), um número por célula.
Mestrado e Doutorado
Ocorrências por tipo de problema, 2023: cancelamento lidera
Violou: Precisão: cinco ângulos parecidos não se comparam a olho. Coerência: 'extravio' e 'perda' de bagagem são categorias que se confundem. Família certa: Comparação → barras ordenadas; e revisar as categorias antes de contar.
Mestrado e Doutorado
Valor médio da causa por cancelamento de voo, jul–dez/2022: queda de 20%
Violou: Eficiência: seis cores para dizer 'seis meses' e nenhum número. Coerência: treemap é proporção de um todo; média por mês não é parte de nada. Família certa: Comparação no tempo → colunas em ordem cronológica, eixo declarado, valor em cada coluna.
Mestrado e Doutorado
Quem reclama de quê: fluxo de processos de cada UF para cada problema, 2022
Violou: Coerência: UF virou número no eixo x e a dispersão sugere correlação entre duas quantidades contínuas. Clareza: vermelho e vinho na mesma legenda. Família certa: Correlação entre duas categóricas → Sankey (ou mapa de calor UF × problema).
Mestrado e Doutorado
Mistura de problemas dentro de cada UF, 2022: atraso domina em SP, RJ e DF
Violou: Coerência: o título promete distribuição por problema, o mapa mostra o total. Clareza: verde/vermelho é juízo de valor e falha para daltônicos. Eficiência: um mapa para cinco UFs. Família certa: Proporção dentro de cada UF → barras 100% empilhadas, com o N ao lado.
Mestrado e Doutorado
Processos por UF dentro de cada problema, 2022: DF lidera em overbooking e atraso
Violou: Coerência: o título diz uma coisa e o rodapé diz outra (por problema ou por UF?). Clareza: vinte barras, cores parecidas, 'Minas Gerias'. Família certa: Comparação → pequenos múltiplos: um painel por problema, mesma escala, UFs na mesma ordem.
Mestrado e Doutorado
Intervalo
Na volta: os seus dados no Painel. Análise investigativa e a construção da história.
Mestrado e Doutorado
Os seus dados no Painel do playground: base e recorte
- Baseas decisões mineradas (Aulas 1 e 2), uma planilha sua (.csv ou .xlsx) ou uma das cinco bases de exemplo. A base de respostas entra na Aula 4.
- Recortefiltros decidem quais linhas entram; a lista de colunas decide o que pode virar eixo. Identificadores e textos longos nunca viram gráfico.
- Prévia com endereçoa prévia mostra o N depois do recorte e o endereço completo: população, recorte, período, fonte e N.
Investigar antes de contar
Antes de pedir o dashboard, percorra a base com perguntas. O que você achar aqui é o que a história vai contar.
Mestrado e Doutorado
Exemplos de Perguntas e Famílias de Propósitos
| Pergunta | Família (cheat sheet) | Exemplo na base |
|---|---|---|
| Quanto? Qual é o N e como se distribui? | informação · distribuição | N total; tempo de tramitação em boxplot |
| Quem ou onde se concentra? | comparação · localização | taxa de procedência por tribunal ou UF, com denominador |
| Quando? Mudou no tempo? | comparação ao longo do tempo | casos por ano; antes e depois de uma mudança de regra |
| O que anda junto? | correlação | valor da causa × indenização; tipo de justiça × resultado |
| O que falta? | informação | quantos casos sem resultado, sem data, sem valor |
Mestrado e Doutorado
Um painel apresenta o resultado numa ordem: contexto, foco, sequência
Contexto
origem, recorte, período, N
Foco
o achado principal em destaque
Sequência
a ordem de leitura conta o argumento
Referências de boa prática: os estudos da ABJ e os painéis estatísticos do CNJ, sobre o DataJud.
Mestrado e Doutorado
Peça em linguagem natural; a gramática dos critérios aceita ou recusa
- "Troque a seção 2 por barras."
- "Mostre por mês."
- "Destaque o principal achado."
- "Remova a última seção."
- "Mude o título para…"
Se o gráfico pedido distorce (pizza com 12 fatias), a mudança é recusada com o critério e a alternativa. Desfazer volta uma versão.
Última seção obrigatória: o quadro de origem, recorte e limitações. É o endereço do painel inteiro.
Mestrado e Doutorado
Construa a história do que você achou
Pedido
pergunta, público, foco: o achado do bloco 5
Gerar
ver a ordem que o Storytelling propôs
Refinar
três pedidos no chat; um deles vai ser recusado
Quadro
origem, recorte, limitações, N
Mestrado e Doutorado
Dois minutos por dupla: a história em três gráficos
Contexto
a base e o recorte, em uma frase
Foco
o achado, com endereço
O que não dá para concluir
Quem ouve responde uma pergunta só: o gráfico sustenta a frase?
Mestrado e Doutorado
Agora vocês sabem o que perguntar aos dados
e como contar o que acharam.
Primeiro a pergunta, depois o ramo, depois o gráfico. E todo número com o endereço ao lado.